home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro121 / sounder.doc < prev    next >
Encoding:
Text File  |  1993-07-05  |  11.0 KB  |  306 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                             
  9.                             
  10.                             
  11.                             
  12.                             
  13.                             
  14.                             
  15.                             
  16.                             
  17.                             
  18.                             
  19.                             
  20.                             
  21.                             
  22.                             
  23.                             
  24.                                STEENBURGH'S STUFF
  25.                             Mildly Useful Utilities
  26.                                 For Batch Files
  27.                                  Version  3.0
  28.           Copyright 1991-1993 by Chuck Steenburgh and Tay-Jee Software
  29.         
  30.                              _______
  31.                         ____|__     |               (TM)
  32.                      --|       |    |-------------------
  33.                        |   ____|__  |  Association of
  34.                        |  |       |_|  Shareware
  35.                        |__|   o   |    Professionals
  36.                      -----|   |   |---------------------
  37.                           |___|___|    MEMBER
  38.         
  39.         
  40.         
  41.         
  42.         
  43.         
  44.         
  45.         
  46.         
  47.         
  48.         
  49.         
  50.         
  51.         
  52.         
  53.         
  54.         
  55.         
  56.         
  57.         
  58.         
  59.         
  60.         
  61.  
  62.                                      Page 1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.         SOUNDER.EXE 3.1                                                 |
  69.         Copyright 1991-1993 Chuck Steenburgh & Tay-Jee Software         |
  70.                
  71.            SOUNDER is an advanced replacement for any number of util-
  72.         ities (with names like BEEP.COM or MUSIC.COM).  Most of these
  73.         programs make a simple noise or maybe play a short melody.
  74.         Most restrict you to the same monotonous tones over and over
  75.         again.  SOUNDER presents you with a virtually unlimited range
  76.         of options which you can control, with ZILLIONS (up to 10 to
  77.         the 400th power!) of possible tone sequences.
  78.                
  79.         Usage:       SOUNDER  [note] [dur] or
  80.                      SOUNDER  [/Ln] [/Rn] [/Tn [+] or
  81.                      SOUNDER  [/En] [/F]                                |
  82.                
  83.                   note            A musical note (A,B,C,D,E,F,G).
  84.                
  85.                   dur             Duration of tone or note in seconds.  |
  86.                                   Must be a whole number between 1-9.   |
  87.         
  88.                   /Ln             Base length for random play.  Spec-
  89.                                   ify the base length of the series of
  90.                                   random tones desired in tenths of a
  91.                                   second, where "n" is the desired tone
  92.                                   length.  0 < n <= 300.
  93.                   
  94.                   /Rn             Repeat random tone sequences "n" num-
  95.                                   ber of times. 0 < n <= 20.
  96.                   
  97.                   /Tn             Specify range of random number of
  98.                                   tones.  1 to n random tones will be
  99.                                   generated per cycle.  0 < n <= 10.
  100.                   
  101.                   +               Make number of tones specified by /T
  102.                                   switch absolute.
  103.                   
  104.                   /En             Use special sound effect number n,    |
  105.                                   where n is one the following four     |
  106.                                   types of sound effects:               |
  107.                                   
  108.                                        1 - increasing pitch             |
  109.                                        2 - decreasing pitch             |
  110.                                        3 - up-down wail                 |
  111.                                        4 - down-up wail                 |
  112.                                       
  113.                   /F              Use in conjunction with /E on very    |
  114.                                   fast PCs to slow down the sounds.     |
  115.         
  116.            The default is for SOUNDER to generate 1-3 random tones with
  117.         an overall tone length of approximately 2/3 second.
  118.                
  119.         Examples:
  120.                
  121.              sounder              Produces 1-3 random tones for a total
  122.  
  123.                                      Page 2
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                   length of approximately 2/3 second.
  130.                
  131.              sounder C 2          Produces a 'C' note for two seconds.
  132.                
  133.              sounder /T5          Produces 1-5 random tones for a total
  134.                                   length of approximately 2/3 second.
  135.                                   
  136.              sounder /T5 /L20     Produces 1-5 random tones for a total
  137.                                   length of 2 seconds.
  138.                                   
  139.              sounder /T5 /L20 +   Produces 5 random tones with a length
  140.                                   of 0.4 second each.
  141.                                   
  142.              sounder /T10 /R3     Produces 3 separate sequences of 1-10
  143.                                   random tones, each of approximately
  144.                                   2/3 second length.
  145.              
  146.              sounder /T10 /R10 +  Produces 100 random tones lasting a
  147.                                   total of approximately 6.7 seconds.
  148.              
  149.              sounder /E1          Produces increasing pitch sound.      |
  150.              
  151.              sounder /E3 /F       Produces up-down wailing sound on a   |
  152.                                   very fast computer (386 or better).   |
  153.         
  154.            SOUNDER returns the following errorlevel codes:
  155.                
  156.              0      Musical note sounded
  157.             1-10    Number of random tones sounded (last cycle only)
  158.             255     Error in note specification/help screen requested   |
  159.             
  160.               
  161.         
  162.         OMBUDSMAN
  163.         
  164.           This program is produced by a member of the Association of
  165.         Shareware Professionals (ASP).  ASP wants to make sure that
  166.         the shareware principle works for you.  If you are unable to
  167.         resolve a shareware-related problem with an ASP member by
  168.         contacting the member directly, ASP may be able to help.  The
  169.         ASP Ombudsman can help you resolve a dispute or problem with
  170.         an ASP member, but does not provide technical support for 
  171.         members' products.  Please write to the ASP Ombudsman at 545
  172.         Grover Road, Muskegon, MI 49442 or send a CompuServe message
  173.         via CompuServe Mail to ASP Ombudsman, 70007,3536.
  174.         
  175.         
  176.         DISCLAIMER
  177.         
  178.            The programs described in this documentation are guaran-
  179.         teed to do absolutely nothing!  They have, however, in my exper-
  180.         ience performed essentially as described herein.  The author
  181.         will not be responsible for any loss or damages caused through
  182.         the use of these programs.  No warranty, express or implied,
  183.  
  184.                                      Page 3
  185.  
  186.  
  187.  
  188.  
  189.  
  190.         is provided for this software's performance, merchantability,
  191.         or fitness for a particular purpose.
  192.         
  193.            All trademarks are property of their respective owners.
  194.         
  195.            The programs and documentation are Copyright 1991,1992 by 
  196.         Chuck Steenburgh.  You are encouraged to distribute these pro-
  197.         grams provided the following conditions are met:
  198.         
  199.            - all files contained in the archive or distribution disk
  200.              must be distributed together in UNMODIFIED form
  201.         
  202.            - you charge no more than a reasonable fee for copying or
  203.              subscription, and clearly indicate that payment of such
  204.              a fee does NOT grant ownership of the programs.
  205.         
  206.            This program is part of set of utilities known as STEEN-
  207.         BURGH'S STUFF (Mildly Useful Utilities).  The full set of
  208.         utilities includes the following programs:
  209.         
  210.              BATBOX:     Simple menu creation/input system
  211.              CHKDRV:     Checks disk drive status
  212.              CHKPRN:     Checks parallel printer status
  213.              CLK:        Displays time on screen
  214.              CURSOR:     Change cursor shape
  215.              DOSVER:     Checks for DOS version currently running
  216.              INPUT:      Simple prompt/input system
  217.              KLS:        Colorful screen-clearing utility
  218.              LAUNCHER:   File selection/execution system
  219.              MUSIC:      Plays transcribed sheet music on the PC
  220.              RAND:       Random number generator
  221.              SKIP:       Prints blank lines from batch files
  222.              SOUNDER:    Wide range of noise making options
  223.              SPACE:      File/disk space reporting utility
  224.              WAITFOR:    Timed pauses 
  225.              WHENISIT:   Date/time telling utility
  226.              WRITE:      Colorful output anywhere on screen
  227.              XD:         Create/switch directories at the same time
  228.         
  229.            You may evaluate these programs for up to 30 days on a free
  230.         trial basis.  After 30 days, you should register your use of
  231.         these programs.  The registration fee is $20, payable to the
  232.         author at the address given below.  For those registering
  233.         directly with Tay-Jee Software, we offer a $5 cash discount.
  234.         
  235.            Let's be real: I don't plan to make a lot of money this way.
  236.         Registration does have its advantages:
  237.         
  238.            - I am improving these programs all the time.  Registration
  239.              will get you IMMEDIATELY a disk with the latest version.
  240.              You will also get the next major release of the program set
  241.              sent to you free of charge.
  242.         
  243.            - While I can't promise to include everyone's suggestions
  244.  
  245.                                      Page 4
  246.  
  247.  
  248.  
  249.  
  250.  
  251.              in program updates, you can bet I'll listen to registered
  252.              users before any of you scrounges out there.
  253.         
  254.            - You will make me feel all warm and fuzzy and appreciated, 
  255.              and all that good stuff.
  256.         
  257.            - You will also get an evaluation copy of my text file for-
  258.              matting program (used to produce the margins in this doc-
  259.              ument), and any other electronic creations I have decided
  260.              to unleash on a foolish, unsuspecting world.
  261.         
  262.            Send comments/registrations to:
  263.         
  264.                 Tay-Jee Software
  265.                 Post Office Box 835
  266.                 Lexington, VA 24450
  267.                 (703)464-5290
  268.                 
  269.                 !!!VIRGINIA RESIDENTS ADD 4.5SALES TAX!!!
  270.         
  271.                 CIS 72330,1776 (I haunt the IBMSYS and IBMPRO forums)
  272.         
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.                                      Page 5